package br.com.it4.zmed.service;

import java.util.List;

import br.com.it4.framework.util.exception.BusinessException;
import br.com.it4.framework.util.exception.SystemException;
import br.com.it4.zmed.entity.Atendimento;
import br.com.it4.zmed.filter.AtendimentoFilter;

/**
 * Interface de acesso as funcionalidades de atendimento.
 * 
 * @author Mozart Silva (mozart.vsilva@gmail.com)
 * 
 */
public interface AtendimentoService {

    /**
     * Adiciona um determinado atendimento.
     * 
     * @param atendimento
     *            O atendimento a ser adicionado.
     * @return O atendimento adicionado.
     * @throws SystemException
     *             Caso ocorra algum erro na execução.
     * @throws BusinessException
     *             Exceção caso ocorra erro na validação.
     */
    public Atendimento addAtendimento(Atendimento atendimento) throws SystemException, BusinessException;

    /**
     * Atualiza um determinado atendimento.
     * 
     * @param atendimento
     *            O atendimento a ser atualizado.
     * @return O atendimento atualizado.
     * @throws SystemException
     *             Caso ocorra algum erro na execução.
     * @throws BusinessException
     *             Exceção caso ocorra erro na validação.
     */
    public Atendimento updateAtendimento(Atendimento atendimento) throws SystemException, BusinessException;

    /**
     * Remove um determinado atendimento.
     * 
     * @param atendimento
     *            O perfil a ser removido.
     * @throws SystemException
     *             Caso ocorra algum erro na execução.
     */
    public void removeAtendimento(Atendimento atendimento) throws SystemException;

    /**
     * Consulta um determinado atendimento a partir da entidade.
     * 
     * @param codigo
     *            O codigo do atendimento a ser consultado.
     * @return A lista de atendimentos.
     * @throws SystemException
     *             Caso ocorra algum erro na execução.
     */
    public Atendimento getAtendimento(Long codigo) throws SystemException;

    /**
     * Consulta a lista de atendimentos.
     * 
     * @param filtro
     *            Filtro para o atendimento.
     * @return A lista de atendimentos.
     * @throws SystemException
     *             Caso ocorra algum erro na execução.
     */
    public List<Atendimento> getAtendimentos(AtendimentoFilter filtro) throws SystemException;

    /**
     * Consulta um determinado número de atendimentos a partir do filtro.
     * 
     * @param filtro
     *            Filtro para o atendimento.
     * @param registroInicio
     *            O registro de inicio retornado.
     * @param registroFim
     *            O registro final retornado.
     * @return A lista de atendimentos.
     * @throws SystemException
     *             Caso ocorra algum erro na execução.
     */
    public List<Atendimento> getAtendimentos(AtendimentoFilter filtro, int registroInicio, int registroFim) throws SystemException;

    /**
     * Calcula o número de registros de atendimentos a partir pelo filtro.
     * 
     * @param filtro
     *            Filtro para o atendimento.
     * @return O número de registros encontrados.
     * @throws SystemException
     *             Caso ocorra algum erro na execução.
     */
    public Long getAtendimentosCount(AtendimentoFilter filtro) throws SystemException;

}